home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XFontsOfFontSet.z / XFontsOfFontSet
Encoding:
Text File  |  1998-10-30  |  8.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXFFFFoooonnnnttttssssOOOOffffFFFFoooonnnnttttSSSSeeeetttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXFFFFoooonnnnttttssssOOOOffffFFFFoooonnnnttttSSSSeeeetttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XFontsOfFontSet, XBaseFontNameListOfFontSet,
  10.           XLocaleOfFontSet, XContextDependentDrawing,
  11.           XContextualDrawing, XDirectionalDependentDrawing - obtain
  12.           fontset information
  13.  
  14.      SSSSYYYYNNNNTTTTAAAAXXXX
  15.           int XFontsOfFontSet(_f_o_n_t__s_e_t, _f_o_n_t__s_t_r_u_c_t__l_i_s_t__r_e_t_u_r_n,
  16.           _f_o_n_t__n_a_m_e__l_i_s_t__r_e_t_u_r_n)
  17.                  XFontSet _f_o_n_t__s_e_t;
  18.                  XFontStruct ***_f_o_n_t__s_t_r_u_c_t__l_i_s_t__r_e_t_u_r_n;
  19.                  char ***_f_o_n_t__n_a_m_e__l_i_s_t__r_e_t_u_r_n;
  20.  
  21.           char *XBaseFontNameListOfFontSet(_f_o_n_t__s_e_t)
  22.                 XFontSet _f_o_n_t__s_e_t;
  23.  
  24.           char *XLocaleOfFontSet(_f_o_n_t__s_e_t)
  25.                 XFontSet _f_o_n_t__s_e_t;
  26.  
  27.           Bool XContextDependentDrawing(_f_o_n_t__s_e_t)
  28.                 XFontSet _f_o_n_t__s_e_t;
  29.  
  30.           Bool XContextualDrawing(_f_o_n_t__s_e_t)
  31.                 XFontSet _f_o_n_t__s_e_t;
  32.  
  33.           Bool XDirectionalDependentDrawing(_f_o_n_t__s_e_t)
  34.                 XFontSet _f_o_n_t__s_e_t;
  35.  
  36.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  37.           _f_o_n_t__s_e_t  Specifies the font set.
  38.  
  39.           _f_o_n_t__n_a_m_e__l_i_s_t__r_e_t_u_r_n
  40.                     Returns the list of font names.
  41.  
  42.           _f_o_n_t__s_t_r_u_c_t__l_i_s_t__r_e_t_u_r_n
  43.                     Returns the list of font structs.
  44.  
  45.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  46.           The _X_F_o_n_t_s_O_f_F_o_n_t_S_e_t function returns a list of one or more
  47.           _X_F_o_n_t_S_t_r_u_c_t_s and font names for the fonts used by the Xmb
  48.           and Xwc layers for the given font set.  A list of pointers
  49.           to the _X_F_o_n_t_S_t_r_u_c_t structures is returned to
  50.           font_struct_list_return.  A list of pointers to null-
  51.           terminated, fully specified font name strings in the locale
  52.           of the font set is returned to font_name_list_return.  The
  53.           font_name_list order corresponds to the font_struct_list
  54.           order.  The number of _X_F_o_n_t_S_t_r_u_c_t structures and font names
  55.           is returned as the value of the function.
  56.  
  57.           Because it is not guaranteed that a given character will be
  58.           imaged using a single font glyph, there is no provision for
  59.           mapping a character or default string to the font
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXFFFFoooonnnnttttssssOOOOffffFFFFoooonnnnttttSSSSeeeetttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXFFFFoooonnnnttttssssOOOOffffFFFFoooonnnnttttSSSSeeeetttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           properties, font ID, or direction hint for the font for the
  75.           character.  The client may access the _X_F_o_n_t_S_t_r_u_c_t list to
  76.           obtain these values for all the fonts currently in use.
  77.  
  78.           Xlib does not guarantee that fonts are loaded from the
  79.           server at the creation of an _X_F_o_n_t_S_e_t.  Xlib may choose to
  80.           cache font data, loading it only as needed to draw text or
  81.           compute text dimensions.  Therefore, existence of the
  82.           per_char metrics in the _X_F_o_n_t_S_t_r_u_c_t structures in the
  83.           _X_F_o_n_t_S_t_r_u_c_t_S_e_t is undefined.  Also, note that all properties
  84.           in the _X_F_o_n_t_S_t_r_u_c_t structures are in the STRING encoding.
  85.  
  86.           The _X_F_o_n_t_S_t_r_u_c_t and font name lists are owned by Xlib and
  87.           should not be modified or freed by the client.  They will be
  88.           freed by a call to _X_F_r_e_e_F_o_n_t_S_e_t with the associated
  89.           _X_F_o_n_t_S_e_t.  Until freed, their contents will not be modified
  90.           by Xlib.
  91.  
  92.           The _X_B_a_s_e_F_o_n_t_N_a_m_e_L_i_s_t_O_f_F_o_n_t_S_e_t function returns the original
  93.           base font name list supplied by the client when the _X_F_o_n_t_S_e_t
  94.           was created.  A null-terminated string containing a list of
  95.           comma-separated font names is returned as the value of the
  96.           function.  White space may appear immediately on either side
  97.           of separating commas.
  98.  
  99.           If _X_C_r_e_a_t_e_F_o_n_t_S_e_t obtained an XLFD name from the font
  100.           properties for the font specified by a non-XLFD base name,
  101.           the _X_B_a_s_e_F_o_n_t_N_a_m_e_L_i_s_t_O_f_F_o_n_t_S_e_t function will return the XLFD
  102.           name instead of the non-XLFD base name.
  103.  
  104.           The base font name list is owned by Xlib and should not be
  105.           modified or freed by the client.  It will be freed by a call
  106.           to _X_F_r_e_e_F_o_n_t_S_e_t with the associated _X_F_o_n_t_S_e_t.  Until freed,
  107.           its contents will not be modified by Xlib.
  108.  
  109.           The _X_L_o_c_a_l_e_O_f_F_o_n_t_S_e_t function returns the name of the locale
  110.           bound to the specified _X_F_o_n_t_S_e_t, as a null-terminated
  111.           string.
  112.  
  113.           The returned locale name string is owned by Xlib and should
  114.           not be modified or freed by the client.  It may be freed by
  115.           a call to _X_F_r_e_e_F_o_n_t_S_e_t with the associated _X_F_o_n_t_S_e_t.  Until
  116.           freed, it will not be modified by Xlib.
  117.  
  118.           The _X_C_o_n_t_e_x_t_D_e_p_e_n_d_e_n_t_D_r_a_w_i_n_g function returns _T_r_u_e if the
  119.           drawing functions implement implicit text directionality or
  120.           if text drawn with the font_set might include context-
  121.           dependent drawing; otherwise, it returns _F_a_l_s_e.
  122.  
  123.           The _X_C_o_n_t_e_x_t_u_a_l_D_r_a_w_i_n_g function returns _T_r_u_e if text drawn
  124.           with the font set might include context-dependent drawing;
  125.           otherwise, it returns _F_a_l_s_e.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXFFFFoooonnnnttttssssOOOOffffFFFFoooonnnnttttSSSSeeeetttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXFFFFoooonnnnttttssssOOOOffffFFFFoooonnnnttttSSSSeeeetttt((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           The _X_D_i_r_e_c_t_i_o_n_a_l_D_e_p_e_n_d_e_n_t_D_r_a_w_i_n_g function returns _T_r_u_e if
  141.           the drawing functions implement implicit text
  142.           directionality; otherwise, it returns _F_a_l_s_e.
  143.  
  144.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  145.           XCreateFontSet(3X11), XCreateOM(3X11), XCreateOC(3X11),
  146.           XExtentsOfFontSet(3X11), XFontSetExtents(3X11)
  147.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.